В поисках соратников: командная доска, гибкие методы и GitHub
- О чём это занятие
- О том, как команде из нескольких студентов работать над одним проектом и не терять друг друга: о договорённостях, гибких методах, командной доске, репозитории на GitHub и файле README, с которого начинается знакомство с проектом.
- Аннотация
- Конспект начинается с того, что ломается в командной работе: невидимая работа, у каждого своё «готово», знания в одной голове, число каналов связи, которое растёт быстрее команды. Второй раздел излагает гибкие методы по первоисточникам – Agile-манифест, руководства по Scrum и Kanban – и отбирает из них то, что подходит учебной команде: недельный спринт, бэклог, оценку работы в очках и скорость команды, ограничение незавершённой работы, определение готовности. Третий раздел посвящён командной доске: какие зоны на ней нужны, как её вести и какую онлайн-доску выбрать. Четвёртый раздел проводит по GitHub: issues и вехи-спринты, доска Projects с оценками, ветки нескольких разработчиков, pull request с ревью и автоматическими тестами, конфликт слияния, релизы. Пятый – пошаговая работа в GitHub Desktop. Шестой – README и Markdown: что должно быть в README, как его читают и как не ошибиться в разметке. Завершает конспект задание – репозиторий и доска команды.
- Пререквизиты
- Из занятия 5 понадобятся паспорт критерия и правила сравнительной таблицы (разделы 4.5 и 7.5): по ним сравнивают аналоги на командной доске и выбирают саму доску. Из занятия 4 – таблица «что искать проектам разных траекторий» (раздел 3.12): хранилища кода и правила лицензий пригодятся при заполнении README. Устанавливать заранее ничего не нужно: GitHub Desktop ставится на занятии.
- Мотивация
- Проект по практике делает команда, а оценивают каждого. На защите спрашивают, кто что сделал, как команда договаривалась и где лежит результат. Ответить на это помогают три вещи: доска, на которой видна работа команды, репозиторий, где у каждого изменения есть автор и дата, и README, по которому проверяющий за пять минут понимает, что это за проект и как его запустить. Те же три вещи потом встретятся на любой работе в разработке.
1. Зачем команде договорённости
Программу, которую пишут четверо, целиком не видит никто, пока её не соберут. Каждый видит свою часть, а общую картину – какая цель, что предстоит сделать, кто чем занят, что уже готово – приходится собирать по разговорам. Поэтому команде нужны средства, которые делают эту картину видимой: договорённости о работе, командная доска и общий репозиторий. Им и посвящено занятие.
Сначала о том, что ломается без них.
- Работа невидима. Каждый что-то делает, но никто, кроме него, не знает, что именно и на каком этапе. О том, что часть работы не сделана, узнают за день до сдачи.
- У каждого своё «готово». Для одного «готово» – код написан, для другого – код проверен, для третьего – код слит в общую ветку и работает у всех. Пока это не записано, каждый честно считает свою часть законченной.
- Работа живёт в переписке. Договорённость, принятая в чате, через неделю тонет под сотней сообщений, и найти, кто что обещал, уже нельзя.
- Всё знает один человек. Если он заболел или ушёл из команды, работа встаёт. В программной инженерии для этого есть мера – «фактор автобуса» (bus factor, truck factor): сколько участников должно выбыть, чтобы проект остановился. В исследовании 2016 года фактор оценили для 133 популярных проектов на GitHub, и у 65 % из них он оказался не больше двух.
Есть и причина, которая с ростом команды только усиливается. Ещё в 1975 году руководитель разработки операционной системы IBM OS/360 Фредерик Брукс заметил, что если каждый участник должен согласовывать работу с каждым, число таких связей равно n(n − 1)/2. У троих – три связи, у четверых – шесть, у шестерых – пятнадцать (рис. 1). Работа на одного человека при этом не уменьшается, а время на согласование растёт почти как квадрат численности команды. Брукс сформулировал из этого закон, который носит его имя: добавление людей в опаздывающий программный проект задерживает его ещё больше.
Отсюда понятно, почему договорённости нужны не «для порядка». Команда снижает число согласований двумя способами: делает работу видимой, чтобы о состоянии дел не приходилось спрашивать каждого, и договаривается заранее, чтобы одни и те же вопросы не решать каждый раз заново. Готовые наборы таких договорённостей существуют уже несколько десятилетий; самые известные из них называют гибкими методами.
2. Гибкие методы: Agile, Scrum, Kanban
О гибкой разработке пишут много, и её легко понять неверно – например, решить, что «гибко» значит «без планов и без документов». Поэтому начнём с первоисточников.
2.1. Agile-манифест
В феврале 2001 года семнадцать разработчиков, авторов разных методов, собрались на горнолыжном курорте Сноуберд в штате Юта и записали то общее, что было в их подходах. Получился короткий текст – «Манифест гибкой разработки программного обеспечения». Его основная часть – четыре ценности:
Люди и взаимодействие важнее процессов и инструментов.
Работающий продукт важнее исчерпывающей документации.
Сотрудничество с заказчиком важнее согласования условий контракта.
Готовность к изменениям важнее следования первоначальному плану.
То есть, не отрицая важности того, что справа, мы всё-таки больше ценим то, что слева.
Agile-манифест разработки программного обеспечения, 2001 (официальный перевод на русский язык)Последняя фраза и есть ответ на главное заблуждение. Манифест не отменяет ни процессов, ни документов, ни планов – он ставит их на второе место после людей, работающего продукта и способности меняться. К ценностям прилагаются двенадцать принципов; для учебной команды важнее всего три из них: выпускать работающий продукт часто – раз в несколько недель или месяцев, и чем чаще, тем лучше; считать работающий продукт главной мерой прогресса; регулярно обсуждать, как работать эффективнее, и менять свою работу.
Сам манифест не говорит, что делать в понедельник утром. Это говорят конкретные методы; ниже – два из них, Scrum и Kanban.
2.2. Scrum
Scrum описан в руководстве его авторов, Кена Швабера и Джеффа Сазерленда; последняя редакция вышла в 2020 году и переведена на русский. Руководство занимает меньше двадцати страниц и определяет немногое: кто участвует, какие события проводятся и какие артефакты получаются (рис. 2).
- Команда. Скрам-команда обычно состоит не более чем из десяти человек. В ней три зоны ответственности: владелец продукта решает, что важнее сделать, и ведёт бэклог; скрам-мастер следит, чтобы команда работала по договорённостям, и убирает помехи; разработчики делают работу. Начальников внутри команды нет: разработчики сами решают, кто, что и как делает.
- События. Работа идёт спринтами – отрезками фиксированной длины, не больше месяца; следующий спринт начинается сразу после предыдущего. Спринт открывает планирование (до восьми часов для месячного спринта), каждый день проходит ежедневный скрам (15 минут), а в конце – обзор спринта, где показывают сделанное (до четырёх часов), и ретроспектива, где обсуждают, как работать лучше (до трёх часов). Для коротких спринтов события короче.
- Артефакты. Бэклог продукта – упорядоченный список всего, что нужно сделать; бэклог спринта – часть его, взятая в текущий спринт; инкремент – работающий результат спринта. У каждого артефакта своё обязательство: у бэклога продукта – цель продукта, у бэклога спринта – цель спринта, у инкремента – определение готовности (Definition of Done), то есть общий для всей команды список условий, при которых работа считается сделанной.
следующий спринт начинается сразу после ретроспективы предыдущего
Смысл этой конструкции – короткая обратная связь. Каждые одну-четыре недели команда получает работающий результат, показывает его и решает, что делать дальше, вместо того чтобы полгода строить по плану, который устарел через месяц. Ретроспектива применяет ту же идею к самой команде: работа над тем, как работать, – тоже часть работы.
2.3. Kanban
Kanban пришёл в разработку из производственной системы «Тойоты», где карточка (по-японски «канбан») сигнализировала, что пора изготовить следующую партию деталей. Руководство по Kanban определяет его как стратегию оптимизации потока ценности через процесс и называет три практики: определять и визуализировать процесс работы, активно управлять элементами работы в этом процессе и улучшать процесс. В отличие от Scrum, в Kanban нет ни спринтов, ни ролей: работа течёт непрерывно, а доска показывает, где она застряла.
Главный инструмент Kanban – ограничение незавершённой работы (work in progress, WIP). На колонку доски ставят предел: например, «в работе» – не больше трёх карточек на команду. Пока колонка заполнена, новую карточку не берут, а помогают закончить начатое (рис. 3). Правило кажется странным – зачем запрещать работать? – но за ним стоит закон Литтла из теории очередей, доказанный Джоном Литтлом в 1961 году. Для устойчивого процесса
среднее время выполнения подзадачи = средний объём незавершённой работы / пропускная способность.
Если у команды одновременно в работе шесть подзадач, а закрывает она три подзадачи в неделю, каждая подзадача в среднем идёт две недели. Если начатых подзадач три, при той же скорости каждая идёт неделю. Команда работает столько же, но каждая подзадача доходит до «готово» вдвое быстрее, и о проблемах становится известно раньше. Руководство по Kanban поэтому предлагает следить за четырьмя показателями потока: объёмом незавершённой работы, пропускной способностью, возрастом подзадачи (сколько она уже в работе) и временем цикла (сколько она шла от начала до конца).
Scrum и Kanban не соперники: можно работать спринтами по Scrum и при этом вести доску по правилам Kanban, с пределами незавершённой работы. Так и стоит работать учебной команде.
2.4. Что взять учебной команде
Учебная команда – не команда в компании: участники видятся раз в неделю, у каждого ещё пять предметов, а заказчиком бывает преподаватель или сотрудник вуза. Поэтому из Scrum и Kanban берут не всё, а то, что окупается при такой нагрузке.
| Практика | Как в Scrum или Kanban | Как в учебной команде |
|---|---|---|
| Спринт | от недели до месяца | неделя: от занятия до занятия, чтобы обзор совпадал со встречей с преподавателем |
| Планирование | до 8 часов на месячный спринт | 15–30 минут в начале недели: цель спринта одной фразой и подзадачи с исполнителями |
| Ежедневный скрам | 15 минут каждый день | письменная сверка 2–3 раза в неделю в одно и то же время: что сделал, что сделаю, что мешает |
| Обзор | показ инкремента заказчику | показ работающей версии на занятии; номер версии – по спринту |
| Ретроспектива | до 3 часов на месячный спринт | 10–15 минут раз в две недели: что помогло, что мешало, какое одно правило меняем |
| Бэклог | упорядоченный список работы | подзадачи – карточками на командной доске или issues в GitHub; порядок и статус – там же |
| Оценка и скорость | размер работы оценивают сами разработчики; в Kanban следят за пропускной способностью | оценка в очках у каждой подзадачи спринта; в спринт берут столько, сколько закрывали в последних спринтах |
| Ограничение WIP | предел на колонку | не больше одной-двух подзадач в работе на человека |
| Определение готовности | обязательство инкремента | 5–6 пунктов в файле CONTRIBUTING.md репозитория (раздел 4.4) |
Чтобы спринт не превращался в список желаний, подзадачи оценивают. Оценивают не в часах – время на незнакомую работу угадать трудно, – а в условных очках, сравнивая подзадачи между собой: 1 – совсем просто, 2 – понятно, как делать, 3 – придётся разбираться, 5 – много работы. Подзадачу на 8 очков и больше делят на части. Оценку ставят вместе на планировании: каждый называет свою, и если оценки расходятся, тот, кто назвал больше, объясняет, что увидел. Так в обсуждение попадает то, что остальные могли упустить.
Сумма очков подзадач, закрытых за спринт, – скорость команды. Незакрытая подзадача не засчитывается частично: она переходит в следующий спринт целиком. По скорости и планируют: в следующий спринт берут примерно столько очков, сколько команда закрывала в среднем за последние два-три спринта, а не столько, сколько хочется сделать. Если разделить оставшийся объём проекта на скорость, получится, сколько спринтов осталось работать, – и сразу видно, успевает ли команда к защите. Как вести оценки на доске Projects, показано в разделе 4.3.
2.5. Как записать подзадачу
В отчёте по практике задача – отдельный этап работы, например проектирование или тестирование и отладка; задачи из введения потом становятся главами (справка «Структура отчёта и ВКР», раздел 2.3). Для спринтов её делят на подзадачи – элементы бэклога, каждый из которых можно сделать за неделю. На онлайн-доске подзадачу записывают карточкой, на GitHub – issue (раздел 4.2). Хорошая подзадача описывает результат, который можно показать, а не действие; её можно оценить и закончить за один спринт; у неё один исполнитель; и в ней записано, как проверить, что работа сделана: что открыть или запустить и что должно получиться. Последнее важнее, чем кажется: без способа проверки спор о том, готова ли подзадача, решается не фактами, а настроением.
Способ проверки и определение готовности – разные вещи. Способ проверки свой у каждой подзадачи: что именно должно получиться. Определение готовности одно на всю команду: что выполняется для любой подзадачи – ревью другого участника, слияние в основную ветку, обновлённая документация. Подзадачу переносят в «Готово», когда выполнено и то и другое.
Перед вами подзадачи из бэклога команды, которая делает небольшую игру. Для каждой выберите главную проблему или «подзадача в порядке»; после ответа появится объяснение.
- Какие две-три договорённости из таблицы раздела 2.4 команде стоит принять уже сейчас, пока идёт проектирование, а какие понадобятся, когда начнётся программирование?
- Что должно быть выполнено, чтобы подзадачу «Сравнительная таблица аналогов» можно было перенести в «Готово»? Опираясь на занятие 5, запишите три-четыре условия, которые проверит человек не из команды.
Договорённости бесполезны, если их никто не видит. Поэтому следующий шаг – доска, на которой видны и договорённости, и работа команды.
3. Командная доска
3.1. Зачем доска
Доска – общее пространство, где команда держит всё, что должно быть на виду: цель и договорённости, анализ аналогов, диаграммы, эскизы экранов, а если команда так решила, то и подзадачи спринта. Один из авторов Agile-манифеста назвал такие вещи информационными радиаторами: они излучают сведения сами, и чтобы узнать состояние дел, никого не нужно спрашивать. В офисе это были доски с карточками на стене, в распределённой команде – онлайн-доски (раздел 3.4).
Хорошая доска экономит те самые согласования из раздела 1. Новый участник открывает её и за десять минут видит, что уже решено и почему. Преподаватель видит, кто чем занят, не устраивая опроса. А сама команда видит то, чего не видно в переписке: что карточка висит в работе вторую неделю или что в колонке «На ревью» скопились карточки.
3.2. Из каких зон состоит доска
Доска делится на зоны, и у каждой зоны своё назначение. Зоны заводят в первый же день, даже если они пока почти пустые: так сразу видно, чего команда ещё не сделала. Каждая зона – отдельный фрейм, а её название пишут крупным текстом внутри фрейма, чтобы его было видно при любом масштабе. Примерная раскладка – на рис. 4.
- Цель и договорённости. Что делает проект и для кого, состав команды с ролями, длина спринта, ссылки на репозиторий и на подзадачи спринта, если они не на доске. С этой зоны начинает каждый, кто открыл доску впервые.
- Анализ. Аналоги и результаты опросов будущих пользователей. Аналоги сравнивают по правилам сравнительной таблицы из занятия 5: сначала задача и пороги, потом критерии со шкалой, единицей и способом измерения, потом значения с источником и датой. На доске такую таблицу удобно держать фреймом – строки-критерии, столбцы-аналоги, – а паспорта критериев переносить в отчёт. Для опроса удобна модель Кано: она делит возможности продукта на обязательные (без них продукт не нужен), линейные (чем лучше сделаны, тем больше нравятся), привлекательные (их не ждут, но им радуются), безразличные и нежелательные. Рядом с результатами пишут дату опроса и решение, которое из него вышло: что делаем первым и почему.
- Диаграммы UML. Диаграммы, которые потом войдут в отчёт: диаграмма прецедентов – кто и что делает с системой, диаграмма классов или компонентов – из каких частей она состоит, ER-модель – какие данные система хранит. Нотацию разберём на занятиях по UML; на доске диаграммы удобно рисовать вместе и править, пока они не устоялись.
- Эскизы экранов. Как будут выглядеть экраны. Новые варианты кладут рядом со старыми, а не поверх: через месяц видно, как менялся интерфейс и почему.
- Ретроспективы. По фрейму на каждую: что помогло, что мешало, какое правило команда меняет. Через несколько недель по ним видно, какие договорённости прижились.
Так выглядят три зоны учебной доски – её подготовили для занятия, данные на ней условные: цель и договорённости (рис. 5), анализ (рис. 6) и ретроспектива (рис. 7).
3.3. Как вести доску
Доска быстро зарастает: через месяц на ней сотни объектов, и найти нужное может только автор. Несколько правил держат её в порядке.
- Зоны – фреймами. Каждая тема – отдельный фрейм (рамка) с названием: «Аналоги», «Диаграммы», «Спринт 5». Фреймы видны в списке, и по ним можно перейти.
- Легенда. Если цвет что-то значит – участника, статус, тип карточки, – на доске есть легенда. Без неё цвет понимает только тот, кто его выбрал.
- Подзадача – результат и исполнитель. Название описывает результат («Метка и очки за точность»), а не деятельность («Работа над графикой»), и у подзадачи один исполнитель. Работа на двоих – это две подзадачи.
- Даты. Фрейм спринта подписан датами, решения – датой, когда их приняли. Через два месяца по доске должно быть понятно, что было раньше.
- Одно место – одна правда. Подзадачи спринта живут в одном месте: если их ведут в GitHub Projects, на доске дают ссылку, а не копию; если на доске – не заводят второй список на GitHub. Две копии одного списка через неделю расходятся.
- Архив. Закрытые спринты и отменённые варианты не удаляют, а сдвигают в отдельную зону: они пригодятся в отчёте и на защите.
3.4. Какую доску выбрать
Онлайн-доску выбирают так же, как любое средство проекта, – по сравнительной таблице из занятия 5: сначала задача и пороги, потом критерии со шкалой и единицей, потом значения с источником и датой.
Задача учебной команды: доска на семестр для анализа, диаграмм, эскизов и ретроспектив; работают 3–5 студентов; иногда доску показывают людям не из команды; платить команда не готова. Порог – бесплатный тариф. Ему отвечают, например, четыре российских сервиса: VK Доска, МТС Линк Доски, sBoard (Эсборд) и доски Битрикс24. Список не полный – онлайн-доски есть и в других платформах, например в Контур.Толке, – и свою таблицу команда собирает тем же способом.
| Критерий (шкала, единица) | VK Доска | МТС Линк Доски | sBoard | Битрикс24 |
|---|---|---|---|---|
| Досок на бесплатном тарифе (абсолютная, штук) | 3 на домен | 3 на пользователя | 3 | без ограничения |
| Кто может работать на доске (абсолютная, человек) | до 5 пользователей, одна команда | одна команда; число участников на странице тарифов не указано | приглашённые после регистрации, без ограничения числа | сотрудники портала, без ограничения числа; внешние участники – по публичной ссылке |
| Как внешний пользователь может открыть доску (наименований: по ссылке / по приглашению) | по приглашению | по ссылке, только просмотр | по приглашению после регистрации; вход без регистрации – на платных тарифах | по публичной ссылке, просмотр или правка; ссылку можно закрыть паролем и ограничить по времени |
| История версий (отношений, дни) | нет | не установлено | 14 | не установлено |
Значения взяты со страниц тарифов и справки сервисов 20 октября 2026 года. «Не установлено» значит, что на странице тарифов и в справке этого нет; такую ячейку проверяют сами, например заведя пробную доску. Перенос досок из Miro умеют VK Доска, МТС Линк и sBoard. У МТС Линк и Битрикс24 доска входит в платформу с видеовстречами, и доску можно открыть прямо на встрече; у МТС Линк на бесплатном тарифе встреча длится до 60 минут и собирает до 30 участников. У sBoard есть MCP-сервер: к доске можно подключить ИИ-агента, и он сам создаёт на ней стикеры, фреймы и связи; у владельца доски – 100 вызовов в сутки.
Победителя в таблице нет, и это правильно: он зависит от задачи. Если в команде больше пяти человек, отпадает VK Доска; если досок нужно больше трёх, остаётся только Битрикс24. Если доску нужно показать человеку не из команды без регистрации, подходят МТС Линк, где по ссылке можно только смотреть, и Битрикс24, где по публичной ссылке можно и смотреть, и править. Если команда хочет, чтобы ИИ-агент сам раскладывал материалы по доске, или ей важна история изменений, – sBoard. Правила раздела 3.3 от выбора не зависят: зоны, легенда, даты и одно место для подзадач нужны на любой доске.
3.5. Где вести подзадачи спринта
Подзадачи спринта можно вести на онлайн-доске – отдельной зоной с колонками «Бэклог», «К выполнению», «В работе», «На ревью», «Готово», – а можно на GitHub, в Issues и Projects (раздел 4). У доски проще порог входа: всё в одном месте, рядом с анализом и диаграммами, и это удобно, пока проект проектируют и кода ещё нет. У GitHub есть то, чего у доски нет: issue связан с кодом. По issue видно, в какой ветке шла работа, прошли ли тесты и кто проверил изменения, а когда pull request слит, карточка сама переезжает в «Готово».
| Что | Где | Почему |
|---|---|---|
| анализ аналогов, опросы, модель Кано | онлайн-доска | свободная раскладка, снимки экрана, стикеры, обсуждение |
| диаграммы, эскизы экранов, ретроспективы | онлайн-доска | рисовать и двигать удобнее, чем описывать |
| подзадачи, спринты, статусы | онлайн-доска или GitHub Issues и Projects – что-то одно | на доске – рядом с анализом; на GitHub – связаны с ветками, pull request и тестами |
| описание проекта, правила работы | README и CONTRIBUTING в репозитории | лежат рядом с кодом, у каждой правки есть автор и дата |
Как устроена работа с подзадачами на GitHub, покажем в разделе 4.
4. GitHub: репозиторий команды
Ниже – работа команды на GitHub по шагам: issues и вехи, доска Projects, ветки, pull request с ревью и проверками, конфликт и релиз. Снимки экрана сделаны в учебном репозитории небольшой игры на Python, где работают два разработчика – назовём их A и Z. Репозиторий подготовлен для занятия: история работы в нём разыграна, а кода ровно столько, сколько нужно для примеров.
4.1. Git за пять минут
GitHub – сервис для хранения репозиториев Git. Git – система контроля версий: она хранит историю всех изменений файлов проекта и позволяет нескольким людям менять их одновременно. Для работы достаточно шести понятий.
- Репозиторий – папка проекта вместе со всей историей изменений.
- Коммит – сохранённый снимок изменений с автором, датой и сообщением о том, что сделано. История проекта – цепочка коммитов.
- Ветка – отдельная линия коммитов. Основная ветка (обычно
main) содержит рабочую версию; новую работу ведут в своей ветке, чтобы не мешать другим. - Слияние (merge) – перенос изменений из одной ветки в другую.
- Удалённый репозиторий (remote) – копия репозитория на GitHub. У каждого участника есть локальная копия на компьютере.
- Отправка и получение (push и pull) – передача коммитов из локальной копии на GitHub и обратно. Fetch только узнаёт о новых коммитах, pull ещё и вливает их в текущую ветку.
На рис. 8 – история учебного репозитория в первом спринте. Каждая подзадача сделана в своей ветке, ветки двух разработчиков живут одновременно, и в main изменения попадают только через pull request.
4.2. Issues, метки, вехи
Подзадачи на GitHub записывают как issues. У issue есть заголовок, описание в Markdown, исполнители, метки, веха и обсуждение. Описание отвечает на два вопроса – что сделать и как проверить, что сделано (раздел 2.5), – а метка и веха показывают тип подзадачи и спринт, к которому она относится (рис. 9).
- Метки (labels) задают тип подзадачи: «enhancement» (новая возможность), «bug» (ошибка), «documentation», «инфраструктура». По метке issues фильтруют.
- Исполнитель (assignee) – тот, кто делает работу. По правилу раздела 3.3 исполнитель один.
- Веха (milestone) – группа issues с датой. Вехи удобно сделать спринтами: «Спринт 1» с 19 по 25 октября, «Спринт 2» с 26 октября по 1 ноября. На странице вехи видна доля закрытых issues – это простейший график хода спринта.
- Шаблоны. Кнопка New issue может предлагать шаблоны – например, «Новая возможность» и «Ошибка» (рис. 10). Шаблоны лежат в папке
.github/ISSUE_TEMPLATE/и превращают описание в форму с обязательными полями: если поле «Как проверить» обязательное, без него issue не создать. Рядом остаётся пустая форма (Blank issue). Её можно скрыть настройкойblank_issues_enabled: false, но участники с правом записи, то есть вся команда, всё равно её видят. Поэтому правило «каждая подзадача – по шаблону» держится на договорённости команды.
Обсуждают подзадачу обычно в чате или на встрече, а в issue записывают итог: что решили и почему. Через месяц такая запись объяснит, почему подзадачу отложили или сделали иначе, чем задумывали.
4.3. Доска в GitHub Projects
Доска на GitHub называется Projects. Это таблица, в которую добавляют issues и pull request из одного или нескольких репозиториев, и её можно показать по-разному: доской с колонками, таблицей или временной шкалой. Колонки доски – значения поля «Статус»; учебной команде достаточно пяти: «Бэклог» – всё, что ещё не взято в спринт; «К выполнению» – взято в текущий спринт, но ещё не начато; «В работе»; «На ревью»; «Готово» (рис. 11).
Две настройки делают доску Projects удобнее доски на стене. Поле типа «Итерация» описывает спринты: задаёшь длину спринта, и подзадачи распределяются по неделям, а доску можно отфильтровать по текущему спринту. Встроенные автоматизации сами двигают карточки: в новом проекте по умолчанию включены правила, по которым закрытый issue и слитый pull request получают статус «Готово». Карточку не нужно двигать руками – она переезжает, когда работа действительно влита в основную ветку.
Третья настройка – числовое поле «Оценка» для очков из раздела 2.4. Если сгруппировать таблицу по спринтам и включить сумму этого поля, в заголовке каждого спринта видно, сколько подзадач и сколько очков в него взято (рис. 12).
На планировании этим пользуются так. Допустим, в первый спринт взяли подзадачи на 12 очков, а к концу недели закрыли пять из них на 9 очков; шестая, на 3 очка, ещё не слита. Скорость первого спринта – 9 очков, а незакрытая подзадача переходит во второй спринт целиком. Значит, во второй спринт стоит брать около 9 очков вместе с перенесённой подзадачей, а не снова 12. Подзадачу без оценки в спринт не берут: если её не получается оценить, в ней чего-то не хватает – например, способа проверки, – и её сначала уточняют.
4.4. Pull request: от ветки к main
Pull request – запрос на слияние ветки в основную. Это главное место командной работы на GitHub: в нём видно, что изменилось, прошли ли тесты, что сказали проверяющие. Работа над подзадачей идёт так:
- Создать ветку от свежего
main. Имя ветки говорит, что в ней:feature/5-fog– новая возможность по issue 5. - Сделать коммиты. Каждый – одно логическое изменение с сообщением, которое отвечает на вопрос «что сделает этот коммит»: «Скрывать клетки дальше двух шагов от игрока».
- Отправить ветку на GitHub и открыть pull request. В описании – что сделано, как проверить и какой issue он закрывает:
Closes #5. - Дождаться проверок. GitHub Actions может на каждый pull request запускать тесты; результат – зелёная или красная отметка (рис. 13).
- Получить ревью: другой участник читает изменения, проверяет их по разделу «Как проверить» и одобряет (Approve). Если есть замечания, он запрашивает правки (Request changes), а автор отвечает новым коммитом в ту же ветку.
- Слить pull request и удалить ветку. Issue, указанный после
Closes, закроется сам, карточка на доске переедет в «Готово».
Ключевые слова, которые закрывают issue при слиянии, – close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved. Работают они только для pull request в основную ветку репозитория: если ветка вливается в другую ветку, issue останется открытым.
Правила работы команды записывают в файл CONTRIBUTING.md в корне репозитория. GitHub показывает ссылку на него, когда кто-то открывает issue или pull request. Туда записывают правила веток, коммитов и pull request и определение готовности, например:
Подзадача готова, когда: - [ ] выполнено всё, что записано в разделе «Как проверить»; - [ ] есть тесты на новое поведение, и все тесты проходят; - [ ] изменения слиты в main через pull request с одобрением; - [ ] README обновлён, если изменилось поведение программы; - [ ] карточка на доске перенесена в колонку «Готово».
Правило «в main только через pull request с одобрением» можно закрепить настройкой защиты ветки в настройках репозитория, если тариф это позволяет. Если нет, правило держится на договорённости, и тогда особенно важно, чтобы оно было записано.
4.5. Конфликт слияния
Конфликт возникает, когда две ветки меняют одни и те же строки. Пример на рисунке: две ветки поменяли функцию draw_dungeon, которая рисует игровое поле. Одна прячет в темноте клетки дальше двух шагов от игрока, другая после того, как игрок поставил метку, показывает сундук на месте клада. Первую ветку слили, и теперь pull request второй сообщает, что у ветки есть конфликты, которые нужно разрешить (рис. 14).
Git не может сам решить, какая из двух правок одних и тех же строк верна, и оставляет обе, помечая их маркерами:
if (x, y) == player:
draw_tile(screen, "player", rect)
<<<<<<< feature/6-mark
elif reveal and (x, y) == level.treasure:
draw_chest(screen, rect)
=======
elif not visible(player, (x, y)):
pygame.draw.rect(screen, DARK, rect)
>>>>>>> main
else:
draw_tile(screen, cell, rect)Между <<<<<<< и ======= – версия одной ветки, между ======= и >>>>>>> – другой. Разрешить конфликт – значит написать код, который учитывает обе правки, удалить маркеры, запустить тесты и сделать коммит с результатом. Здесь нужны обе проверки, но важен их порядок. Если первой поставить проверку темноты, сундук, до которого не достаёт свет факела, так и останется в темноте, и проверка «после метки видно, где клад был на самом деле» не пройдёт. Поэтому первой идёт проверка метки, второй – темноты. Сделать это можно в браузере кнопкой Resolve conflicts, в GitHub Desktop или в VS Code: все три показывают конфликтующие места и предлагают выбрать одну версию, другую или обе. Вариант «обе» ставит правки подряд в порядке веток и о смысле кода не знает, поэтому результат всё равно читают и проверяют тестами.
Конфликтов меньше, когда ветки живут недолго: подзадача на день-два, а не на две недели. Чем дольше ветка расходится с main, тем больше в ней строк, которые успел поменять кто-то другой. Помогает и договорённость на планировании: подзадачи, которые меняют одну функцию, делать по очереди.
4.6. Релизы и номера версий
Когда спринт закончен, его результат помечают версией. В Git это тег – метка на коммите, а на GitHub – релиз: тег с описанием изменений и, если нужно, файлами для скачивания. Номера версий удобно писать по правилам семантического версионирования: MAJOR.MINOR.PATCH. Последнюю цифру увеличивают для исправлений, среднюю – для новых возможностей, первую – для изменений, несовместимых с прежними; версии 0.y.z означают, что проект ещё в начальной разработке и всё может меняться.
В описании релиза пишут, что умеет версия и какие у неё известные ограничения; ниже GitHub сам добавляет список вошедших pull request (рис. 15).
Выпускать версию стоит в конце каждого спринта, даже если изменений немного. Релиз фиксирует то, что команда показала на обзоре, и к нему можно вернуться, если следующая версия что-то сломает. Описание релиза пишут для пользователя, а не для разработчиков: что нового, что исправлено, что пока не работает. К концу семестра список релизов становится готовой историей проекта: по нему видно, как продукт рос неделю за неделей, и его можно приложить к отчёту как доказательство хода работы.
GitHub – не единственное хранилище кода. В России работают GitVerse, GitFlic и Мос.Хаб; issues, ветки, запросы на слияние и релизы в них устроены похоже, так что всё сказанное переносится почти без изменений.
5. GitHub Desktop: работа без командной строки
С Git работают из командной строки, из среды разработки или из отдельной программы. Для начала удобнее всего GitHub Desktop – бесплатная программа для Windows и macOS, в которой каждое действие – кнопка, а изменения видно до того, как они сохранены. Git входит в её состав, ставить его отдельно не нужно.
5.1. Установка и вход
Программу скачивают с desktop.github.com. После установки она предлагает войти в учётную запись GitHub – это нужно, чтобы отправлять изменения; вход выполняется через браузер, пароль в программу вводить не нужно. Позже учётную запись можно сменить в меню File → Options → Accounts. При первом запуске программа предлагает пройти встроенное обучение на тренировочном репозитории (рис. 16) – это пятнадцать минут, которые стоит потратить.
В окне всё время видны три вещи. Сверху – текущий репозиторий, текущая ветка и кнопка синхронизации, которая в зависимости от состояния называется Fetch origin, Pull origin или Push origin. Слева – вкладки Changes (несохранённые изменения) и History (история коммитов). Внизу слева – поле сообщения коммита и кнопка Commit.
5.2. Получить репозиторий
Если репозиторий команды уже создан на GitHub, его клонируют – получают локальную копию: File → Clone repository (Ctrl+Shift+O). Программа показывает все репозитории, к которым у учётной записи есть доступ; остаётся выбрать нужный и папку на диске (рис. 17).
Если репозитория ещё нет, его создают: File → New repository (рис. 18). В этом окне сразу задают три вещи, которые потом легко забыть: флажок Initialize this repository with a README создаёт README, список Git ignore добавляет файл .gitignore со списком того, что не нужно хранить в репозитории (для Python – кэш и виртуальное окружение), список License – файл лицензии. Новый репозиторий существует только на компьютере; на GitHub его отправляет кнопка Publish repository, и тут же можно выбрать, будет ли он закрытым.
5.3. Рабочий цикл
Работа над подзадачей в GitHub Desktop повторяет шаги раздела 4.4, только каждый шаг – кнопка.
- Обновиться. Перейти на
mainи нажать Fetch origin, затем Pull origin, если программа нашла новые коммиты. Новую работу начинают от свежей версии. - Создать ветку. Current branch → New branch (Ctrl+Shift+N), имя по правилу команды:
feature/5-fog. - Изменить файлы в редакторе. Открыть проект в VS Code можно из программы: Repository → Open in Visual Studio Code (Ctrl+Shift+A).
- Просмотреть изменения на вкладке Changes: слева список файлов, справа построчная разница – удалённое красным, добавленное зелёным. Флажки у файлов определяют, что войдёт в коммит.
- Сделать коммит. В поле Summary – короткое сообщение о том, что делает коммит, в Description – подробности, если нужны. Кнопка Commit to <ветка> сохраняет коммит локально. Сообщение вроде «12» или «правки» через неделю ничего не скажет; лучше «Скрывать клетки дальше двух шагов от игрока».
- Отправить. Publish branch для новой ветки или Push origin для уже опубликованной.
- Открыть pull request. Кнопка Create Pull Request (Ctrl+R) открывает страницу GitHub с заготовкой запроса; дальше – описание по шаблону, проверки и ревью.
- После слияния перейти на
main, сделать Pull origin и удалить ветку: Branch → Delete.
5.4. Конфликт в GitHub Desktop
Чтобы подтянуть в свою ветку свежий main, в программе есть команда Branch → Update from main. Если кто-то успел изменить те же строки, программа сообщает о конфликте и показывает список файлов с конфликтами. У каждого файла есть кнопка открыть его в редакторе; VS Code подсвечивает конфликтующие места и предлагает принять одну версию, другую или обе. После правки файл сохраняют, программа отмечает конфликт разрешённым, и кнопка Continue merge завершает слияние. Дальше – как в разделе 4.5: запустить тесты и только потом отправлять.
5.5. Кнопки и команды
Каждой кнопке GitHub Desktop соответствует команда Git. Знать их полезно: в инструкциях, на форумах и в ответах нейросетей пишут именно команды.
| Действие | GitHub Desktop | Командная строка |
|---|---|---|
| получить репозиторий | File → Clone repository | git clone <адрес> |
| создать ветку и перейти на неё | Current branch → New branch | git switch -c feature/5-fog |
| посмотреть изменения | вкладка Changes | git status, git diff |
| сделать коммит | Summary → Commit to … | git add -A; git commit -m "…" |
| отправить на GitHub | Publish branch / Push origin | git push -u origin feature/5-fog |
| узнать о новых коммитах | Fetch origin | git fetch |
| получить новые коммиты | Pull origin | git pull |
| влить main в свою ветку | Branch → Update from main | git merge main |
| история | вкладка History | git log --oneline --graph |
Тот же цикл можно пройти в VS Code: панель Source Control показывает изменения, поле сообщения и кнопку Commit, а ветки переключаются в строке состояния внизу окна. Выбор инструмента – дело вкуса; важно, чтобы вся команда соблюдала одни правила веток и сообщений.
6. README и Markdown
README – файл, который GitHub показывает на главной странице репозитория. С него начинает знакомство с проектом каждый: новый участник, преподаватель, член комиссии, работодатель, который смотрит профиль выпускника. За первые минуты README должен ответить на их вопросы, иначе дальше никто не пойдёт.
6.1. Что должно быть в README
| Раздел | На какой вопрос отвечает | Пример |
|---|---|---|
| название и одна-две фразы | что это и для кого | «Небольшая компьютерная игра: найти клад по старой карте и поставить метку» |
| значки состояния | работает ли сейчас | значок тестов GitHub Actions |
| возможности | что программа умеет и что в работе | список со ссылками на issues |
| быстрый старт | как запустить за пять минут | команды, которые можно скопировать, и снимок окна игры |
| требования | что нужно установить | Python 3.10 или новее, библиотека pygame; pytest для тестов |
| структура проекта | где что лежит | таблица «путь – что там» |
| как мы работаем | как участвовать | где подзадачи и спринты, схема работы с ветками, ссылка на CONTRIBUTING.md |
| команда | кто делал и кто за что отвечает | таблица участников с ролями |
| лицензия | можно ли использовать | MIT со ссылкой на файл LICENSE |
Так может начинаться README (рис. 19): каждый раздел отвечает на один вопрос, команды можно скопировать, а правила работы вынесены в отдельный файл, чтобы README оставался коротким.
Главное правило – README пишут для того, кто видит проект впервые. Автор знает, что игра запускается командой python -m dungeon levels/01_cellar.txt, а новичок этого не знает и не догадается. Поэтому лучшая проверка README – попросить человека не из команды склонировать репозиторий и запустить проект по README, ни о чём не спрашивая. Каждый его вопрос – недостающая строка.
6.2. README по ходу проекта
README не пишут в последний день. Его заводят в первом спринте отдельной подзадачей и дополняют каждый спринт, и тогда он совпадает с тем, что умеет программа: если pull request меняет поведение программы, в нём же обновляют README – это пункт определения готовности (раздел 4.4).
- В первый день – название, одна-две фразы о проекте, команда с ролями, раздел «Как мы работаем» со ссылкой на CONTRIBUTING.md. Раздел «Возможности» – тем, что команда собирается сделать, со ссылками на подзадачи.
- Когда появилась первая версия – быстрый старт: команды, которые можно скопировать, и пример того, что программа выведет, или снимок её окна. Здесь же – ссылка на страницу релизов, откуда можно скачать готовую сборку.
- С каждым релизом – обновлённые «Возможности»: что готово, что в работе, что в планах. Если у программы есть интерфейс – свежий снимок экрана.
Больше всего времени новичку экономят быстрый старт и структура проекта (рис. 20). Команды записаны блоками кода, и GitHub добавляет к каждому блоку кнопку копирования. Под командами – снимок окна: читатель сразу видит, что должно открыться, и может сравнить со своим экраном. Таблица структуры отвечает на вопрос «где что лежит» раньше, чем его зададут.
6.3. Markdown: основы
README пишут на Markdown – языке разметки, который придумал Джон Грубер в 2004 году. Идея в том, что исходный текст читается и без обработки: заголовок отмечен решёткой, курсив – звёздочками, список – дефисами. Первоначальное описание языка оставляло много неясностей, и разные программы показывали один и тот же текст по-разному. Сейчас у языка есть строгая спецификация CommonMark (версия 0.31.2, 2024 год), а GitHub использует её расширение – GitHub Flavored Markdown (GFM), в котором добавлены таблицы, списки с флажками, зачёркивание и автоматические ссылки. Как один и тот же текст выглядит до и после обработки, показывает рис. 21.
# Подземелье картографа Игра: найти **клад** по старой карте и поставить метку. ## Быстрый старт 1. Склонировать репозиторий. 2. Запустить: ```bash python -m dungeon levels/01_cellar.txt ``` | Клавиша | Действие | |---------|----------| | W A S D | идти | - [x] ходьба и факел - [ ] метка и очки Подробнее – в [CONTRIBUTING](CONTRIBUTING.md).
Подземелье картографа
Игра: найти клад по старой карте и поставить метку.
Быстрый старт
- Склонировать репозиторий.
- Запустить:
python -m dungeon levels/01_cellar.txt
| Клавиша | Действие |
|---|---|
| W A S D | идти |
- ходьба и факел
- метка и очки
Подробнее – в CONTRIBUTING.
| Что нужно | Как написать | Замечание |
|---|---|---|
| заголовки | # Раздел ## Подраздел | после решёток – пробел; уровней шесть; один заголовок первого уровня на файл |
| абзац | пустая строка между абзацами | одиночный перевод строки абзац не разрывает |
| выделение | **полужирный**, *курсив*, ~~зачёркнутый~~ | зачёркивание – расширение GFM |
| списки | - пункт 1. пункт | вложенный список – отступ в 2–4 пробела |
| ссылка | [текст](https://адрес) | на файл репозитория – относительный путь: [лицензия](LICENSE) |
| картинка |  | текст в квадратных скобках – описание для тех, кто картинку не видит |
| код в строке | `python -m dungeon` | имена файлов, команды, значения |
| блок кода | ```bash … ``` | после трёх обратных кавычек – язык, тогда код будет подсвечен |
| таблица | | A | B | |---|---| | строка из дефисов под заголовком обязательна; расширение GFM |
| список с флажками | - [ ] не сделано - [x] сделано | в issues и pull request флажки можно отмечать мышью |
| цитата | > текст | цитаты могут быть вложенными: >> |
6.4. Возможности GitHub
Кроме GFM, GitHub понимает в Markdown ещё несколько вещей, которые делают README и issues нагляднее.
- Ссылки на issues и людей.
#12превращается в ссылку на issue или pull request с этим номером,@логин– в упоминание участника, который получит уведомление. - Выделенные блоки. Цитата, которая начинается с
[!NOTE],[!TIP],[!IMPORTANT],[!WARNING]или[!CAUTION], показывается цветным блоком с заголовком – для важных предупреждений. - Диаграммы. Блок кода с языком
mermaidGitHub рисует как диаграмму. Схему работы с ветками удобно записать таким блоком из семи строк текста. - Относительные ссылки и картинки. Путь
docs/screen.pngработает и на GitHub, и в локальной копии, и в любой ветке; абсолютный адрес картинки из чужой ветки сломается, как только ветку удалят.
```mermaid
flowchart LR
A[Подзадача в Issues] --> B[Ветка feature/номер-кратко]
B --> C[Коммиты]
C --> D[Pull request]
D --> E{Тесты и ревью}
E -- замечания --> C
E -- одобрено --> F[Слияние в main]
```6.5. Где ошибаются в Markdown
Ниже собраны самые частые неожиданности Markdown. Проверять их удобно на GitHub: любой файл .md там открывается в двух режимах – Code (исходный текст) и Preview (результат), и так же стоит проверять свой README перед тем, как считать его готовым.
- Подчёркивания внутри слова.
Тоже**полужирный**текствыделит середину слова, аНе__полужирный__текст– нет: подчёркивания внутри слова не считаются разметкой, чтобы не портить имена вродеsnake_case_name. - Номера в списке. Нумерованный список начинается с первого числа, а остальные номера Markdown пересчитывает сам: пункты
1. 2. 4. 1000. 11.покажутся как 1, 2, 3, 4, 5. - Решётка без пробела.
#Заголовок– не заголовок, а обычный текст: после решёток нужен пробел. - Пустые строки. Список или таблица сразу после строки текста без пустой строки между ними иногда не распознаются: перед списками, таблицами и блоками кода оставляют пустую строку.
- Перенос строки. Чтобы начать новую строку внутри абзаца, в конце строки ставят обратную косую черту или два пробела – невидимые пробелы легко потерять, поэтому черта надёжнее.
- Звёздочка как символ. Чтобы показать
*,_или#как обычный знак, перед ним ставят обратную косую черту:\*.
Вверху – фрагмент Markdown. Выберите, как его покажет GitHub; после ответа появится объяснение.
7. Задание: репозиторий и доска команды
Задание соединяет всё изложенное: команда заводит репозиторий и доску, договаривается о правилах, планирует первый спринт и проводит работу через полный цикл – от подзадачи до слияния. Результат пригодится в отчёте и на защите: по репозиторию и доске видно, кто что сделал и как шла работа.
- Репозиторий. Один участник создаёт репозиторий проекта на GitHub и приглашает остальных и преподавателей (Settings → Collaborators): Zlonikov и EvgenieLebedev. Результатадрес репозитория, все участники в списке.
- README и правила. Заполнить README по шаблону: что это, быстрый старт (пусть пока это «как открыть проект»), структура, команда с ролями, лицензия. Добавить CONTRIBUTING.md с правилами веток, коммитов, pull request и определением готовности из 5–6 пунктов. РезультатREADME, который человек не из команды понимает без вопросов.
- Бэклог. Записать 6–10 подзадач – карточками на онлайн-доске или issues в GitHub: результат, исполнитель, оценка в очках и способ проверки. Пока идёт проектирование, это могут быть диаграммы, сравнение аналогов, эскизы экранов. Результатбэклог, в котором каждую подзадачу можно проверить.
- Спринт 1. Выбрать в спринт 3–5 подзадач, у каждой один исполнитель; цель спринта – одной фразой. Если подзадачи на GitHub – веха «Спринт 1» и доска Projects с колонками «Бэклог», «К выполнению», «В работе», «На ревью», «Готово»; если на онлайн-доске – фрейм спринта с теми же колонками и датами. Результатдоска спринта.
- Работа через pull request. Каждый участник проводит хотя бы одну работу через репозиторий: ветка – коммиты с понятными сообщениями – pull request по шаблону – ревью другого участника – слияние. Подойдёт и работа без кода: раздел README, файл диаграммы, сравнение аналогов. Если подзадача в Issues, pull request закрывает её словом
Closes #N. Результатпо одному слитому pull request на участника. - Доска. На онлайн-доске (VK Доска, МТС Линк Доски, sBoard, Битрикс24 или другой) – зоны из раздела 3.2 с названиями внутри фреймов, легенда, даты; аналоги проекта сравнены по критериям с паспортами из занятия 5. Результатссылка на доску.
- Ретроспектива. В конце недели – 10 минут: что помогло, что мешало, какое одно правило меняем. Записать итог на доске или в README. Результаттри строки и одно изменение.
z06_readme_template.md шаблон README.
Работа принимается, если:
- README отвечает на вопросы раздела 6.1, и по нему проект открывает человек не из команды;
- в CONTRIBUTING.md есть определение готовности, и слитые pull request ему соответствуют;
- у каждой подзадачи спринта есть исполнитель, оценка и способ проверки, и все подзадачи лежат в одном месте – на доске Projects или во фрейме спринта;
- у каждого участника есть хотя бы один слитый pull request, который прошёл ревью другого участника;
- на онлайн-доске есть зоны с названиями, легенда и даты, а аналоги сравнены по критериям из занятия 5.
Через неделю работы репозиторий и доска сами расскажут, как работает команда: кто какие подзадачи закрыл, сколько их было в спринте, сколько висело на ревью. На защите это лучший ответ на вопрос «кто что сделал» – и для этого его не нужно специально готовить.
8. Свод практик
Ниже правила занятия собраны вместе. Каждое уже встречалось в разделах 1–7; на лицевой стороне карточки – само правило, на обороте – как его применять, а в квадратных скобках – номера источников из списка в конце страницы.
Команда
Процесс
Доска
GitHub
README
Контрольные вопросы
-
Если каждый согласует работу с каждым, связей n(n − 1)/2: у троих три, у четверых шесть, у шестерых пятнадцать. Отсюда закон Брукса: добавление людей в опаздывающий проект задерживает его ещё больше.
-
Сколько участников должно выбыть, чтобы проект остановился. У 65 % из 133 популярных проектов GitHub он не больше двух. Если часть проекта знает один человек, его болезнь останавливает работу; снижают риск ревью, README и описания pull request.
-
Нет. Манифест прямо говорит: «не отрицая важности того, что справа, мы всё-таки больше ценим то, что слева». Процессы, документы и планы остаются, но на втором месте после людей, работающего продукта, сотрудничества с заказчиком и готовности к изменениям.
-
Роли: владелец продукта, скрам-мастер, разработчики; команда обычно не больше десяти человек. События: спринт до месяца, планирование, ежедневный скрам на 15 минут, обзор, ретроспектива. Артефакты: бэклог продукта (цель продукта), бэклог спринта (цель спринта), инкремент (определение готовности).
-
По закону Литтла среднее время выполнения равно объёму незавершённой работы, делённому на пропускную способность. Шесть подзадач в работе при трёх закрытых в неделю – две недели на подзадачу, три подзадачи – неделя. Команда работает столько же, а результат появляется вдвое быстрее.
-
Сумма очков подзадач, закрытых за спринт; незакрытая подзадача не засчитывается частично и переходит в следующий спринт целиком. В следующий спринт берут примерно столько, сколько команда закрывала в среднем за два-три последних спринта. Например, взяли 12 очков, закрыли 9 – скорость 9, и в следующий спринт берут около 9 очков, а не снова 12. Оставшийся объём, делённый на скорость, показывает, успевает ли команда к сроку.
-
Способ проверки свой у каждой подзадачи: что открыть или запустить и что должно получиться. Определение готовности одно на команду: что выполняется для любой подзадачи – ревью, слияние, документация. Подзадача готова, когда выполнено и то и другое.
-
Как результат, который можно показать, а не как действие; с одним исполнителем; так, чтобы она укладывалась в спринт; с оценкой в очках и способом проверки. «Сделать бэкенд» не годится: это действие без результата и без конца.
-
Цель и договорённости, анализ (аналоги по критериям, опросы), диаграммы UML, эскизы экранов, ретроспективы, архив. Каждая зона – фрейм, её название написано крупным текстом внутри фрейма; цвет объяснён легендой; решения подписаны датой; закрытое – в архиве; подзадачи спринта – отдельной зоной или в GitHub Projects, но в одном месте.
-
По сравнительной таблице из занятия 5: задача и пороги (бесплатный тариф, 3–5 участников, показ людям не из команды), критерии со шкалой и единицей (число досок, кто может работать, как внешний пользователь откроет доску, история версий), значения со страниц тарифов с датой. Признак, одинаковый у всех вариантов, выбрать не помогает; победитель зависит от задачи.
-
На доске – анализ аналогов, опросы, диаграммы, эскизы и ретроспективы: их удобно рисовать и двигать. Подзадачи и спринты – либо на доске, либо в Issues и Projects, где issue связан с веткой, pull request и тестами; главное, в одном месте. Описание проекта и правила работы – в README и CONTRIBUTING.
-
Коммит – сохранённый снимок изменений с автором, датой и сообщением. Ветка – отдельная линия коммитов. Слияние переносит изменения из одной ветки в другую. Push отправляет локальные коммиты на GitHub, pull получает новые и вливает их в текущую ветку; fetch только узнаёт о них.
-
Написать в описании pull request ключевое слово и номер: Closes #5 (подойдут close, fix, resolve в разных формах). Работает, только если pull request вливается в основную ветку; на доске Projects карточка при этом сама переедет в «Готово».
-
Две ветки изменили одни и те же строки, и Git не может выбрать сам. Он оставляет обе версии между маркерами <<<<<<<, ======= и >>>>>>>. Нужно написать код, учитывающий обе правки, удалить маркеры, запустить тесты и сделать коммит. Конфликтов меньше, когда ветки короткие.
-
Семантическое версионирование MAJOR.MINOR.PATCH: последняя цифра – исправления, средняя – новые возможности, первая – несовместимые изменения. Версии 0.y.z – начальная разработка. Релиз на GitHub – тег с описанием изменений.
-
Перейти на main и обновиться (Fetch, Pull); создать ветку (New branch); изменить файлы; просмотреть изменения на вкладке Changes; коммит с понятным сообщением; Publish branch или Push; Create Pull Request; после слияния – Pull на main и удаление ветки.
-
Что это и для кого, значки состояния, возможности, быстрый старт с командами и примером результата, требования, структура проекта, правила работы, команда с ролями, лицензия. Проверка: человек не из команды запускает проект по README, ни о чём не спрашивая.
-
Подчёркивания внутри слова не считаются разметкой, чтобы не портить имена вроде snake_case_name; звёздочки внутри слова работают. Другие частые ловушки: пробел после решёток в заголовке, пустая строка перед списком и таблицей, перенос строки внутри абзаца.
Источники
Список оформлен в виде затекстовых ссылок (ГОСТ Р 7.0.5–2008, ГОСТ Р 7.0.108–2022). Дата обращения к сетевым источникам – 19 и 20 октября 2026 года.
Команда и гибкие методы
- Brooks F. P. The Mythical Man-Month: Essays on Software Engineering. — Reading (Mass.) : Addison-Wesley, 1975.
- Avelino G., Passos L., Hora A., Valente M. T. A Novel Approach for Estimating Truck Factors : preprint // arXiv. — 2016. — arXiv:1604.06766. — URL: https://arxiv.org/abs/1604.06766 (дата обращения: 19.10.2026).
- Манифест гибкой разработки программного обеспечения : [сайт]. — 2001. — URL: https://agilemanifesto.org/iso/ru/manifesto.html (дата обращения: 19.10.2026).
- Основополагающие принципы Agile-манифеста : [сайт]. — 2001. — URL: https://agilemanifesto.org/iso/ru/principles.html (дата обращения: 19.10.2026).
- Швабер К., Сазерленд Дж. Руководство по Scrum. — 2020. — URL: https://scrumguides.org/docs/scrumguide/v2020/2020-Scrum-Guide-Russian.pdf (дата обращения: 19.10.2026).
- Coleman J., Vacanti D., Johnson C. [et al.]. The Kanban Guide. — Version 2025.5. — URL: https://kanbanguides.org/the-kanban-guide/2025.5/ (дата обращения: 19.10.2026).
- Little J. D. C. A Proof for the Queuing Formula: L = λW // Operations Research. — 1961. — Vol. 9, No. 3. — P. 383–387. — DOI: 10.1287/opre.9.3.383.
Командная доска
- Cockburn A. Agile Software Development. — Boston : Addison-Wesley, 2001.
- Kano N., Seraku N., Takahashi F., Tsuji S. Attractive Quality and Must-Be Quality // Hinshitsu (Quality). — 1984. — Vol. 14, No. 2. — P. 147–156. — DOI: 10.20684/quality.14.2_147. — На яп. яз.
- Тарифы платформы VK WorkSpace // VK WorkSpace : документация. — Обновлено 24.06.2026. — URL: https://workspace.vk.ru/docs/saas/tariffs-bills/tariffs/ (дата обращения: 20.10.2026).
- Тарифы // МТС Линк : [сайт]. — URL: https://mts-link.ru/tariffs/ (дата обращения: 20.10.2026).
- Тарифы для вашей команды // Эсборд (sBoard) : [сайт]. — URL: https://sboard.online/pricing (дата обращения: 20.10.2026).
- Подробное сравнение тарифов // Битрикс24 : [сайт]. — URL: https://www.bitrix24.ru/prices/compare_cloud_plans.php (дата обращения: 20.10.2026).
- Битрикс24 Доски: пространство для визуализации идей // Битрикс24 : база знаний. — URL: https://helpdesk.bitrix24.ru/open/23361080/ (дата обращения: 20.10.2026).
- Новое в Досках: возможности и условия использования // Контур.Толк : справка. — URL: https://kontur.ru/talk/spravka/84119-vozmozhnosti_i_usloviya_ispolzovaniya (дата обращения: 20.10.2026).
GitHub и Git
- Chacon S., Straub B. Pro Git. — 2-е изд. — Apress, 2014. — URL: https://git-scm.com/book/ru/v2 (дата обращения: 19.10.2026).
- About issues // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/issues/tracking-your-work-with-issues/learning-about-issues/about-issues (дата обращения: 19.10.2026).
- Syntax for issue forms // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms (дата обращения: 19.10.2026).
- Configuring issue templates for your repository // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository (дата обращения: 19.10.2026).
- About Projects // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects (дата обращения: 19.10.2026).
- About iteration fields // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields (дата обращения: 19.10.2026).
- Using the built-in automations // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations (дата обращения: 19.10.2026).
- Pull requests // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/pull-requests/reference/pull-requests (дата обращения: 19.10.2026).
- Linking a pull request to an issue // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue (дата обращения: 19.10.2026).
- Merge conflicts // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/pull-requests/reference/merge-conflicts (дата обращения: 19.10.2026).
- Setting guidelines for repository contributors // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors (дата обращения: 19.10.2026).
- About releases // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases (дата обращения: 19.10.2026).
- Preston-Werner T. Семантическое версионирование 2.0.0 : [сайт]. — URL: https://semver.org/lang/ru/ (дата обращения: 19.10.2026).
- GitVerse : [сайт]. — URL: https://gitverse.ru/; GitFlic : [сайт]. — URL: https://gitflic.ru/; Мос.Хаб : [сайт]. — URL: https://hub.mos.ru/ (дата обращения: 19.10.2026).
GitHub Desktop
- Getting started with GitHub Desktop // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/desktop/overview/getting-started-with-github-desktop (дата обращения: 19.10.2026).
- Download GitHub Desktop : [сайт]. — URL: https://desktop.github.com/download/ (дата обращения: 19.10.2026).
README и Markdown
- About the repository README file // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes (дата обращения: 19.10.2026).
- Gruber J. Markdown // Daring Fireball : [сайт]. — 2004. — URL: https://daringfireball.net/projects/markdown/ (дата обращения: 19.10.2026).
- CommonMark Spec. — Version 0.31.2. — 2024. — URL: https://spec.commonmark.org/0.31.2/ (дата обращения: 19.10.2026).
- GitHub Flavored Markdown Spec. — Version 0.29-gfm. — 2019. — URL: https://github.github.com/gfm/ (дата обращения: 19.10.2026).
- Basic writing and formatting syntax // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax (дата обращения: 19.10.2026).
- Creating diagrams // GitHub Docs : [сайт]. — URL: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams (дата обращения: 19.10.2026).